home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr27 / mdir_v10.zip / MDIR10.DOC < prev    next >
Text File  |  1995-03-21  |  13KB  |  469 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                  Mike's Directory Fast
  29.  
  30.  
  31.                   Version 1.0
  32.  
  33.  
  34.            Copyright (c) 1995 by Michael Jonathon Pierce
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                    page 1
  62.  
  63.  
  64.                    Table of Contents
  65.                    -----------------
  66.  
  67.      Disclaimer of warranty. . . . . . . . . . . . . . . . . . . .  2
  68.  
  69.      License and Distribution Terms  . . . . . . . . . . . . . . .  2
  70.  
  71.      Copyright Information . . . . . . . . . . . . . . . . . . . .  2
  72.  
  73.      Introduction. . . . . . . . . . . . . . . . . . . . . . . . .  3
  74.  
  75.      Installation. . . . . . . . . . . . . . . . . . . . . . . . .  3
  76.     2.1 Option One . . . . . . . . . . . . . . . . . . . . . .  3
  77.     2.2 Option Two . . . . . . . . . . . . . . . . . . . . . .  4
  78.     2.3 Option Three . . . . . . . . . . . . . . . . . . . . .  4
  79.     2.4 Hints. . . . . . . . . . . . . . . . . . . . . . . . .  4
  80.  
  81.      Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  82.  
  83.      Options . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  84.     4.1  h or H or ? . . . . . . . . . . . . . . . . . . . . .  5
  85.     4.2  1 . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  86.     4.3  2 . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  87.     4.4  4 . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  88.     4.5  6 . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  89.     4.6  e or E. . . . . . . . . . . . . . . . . . . . . . . .  5
  90.     4.7  n or N. . . . . . . . . . . . . . . . . . . . . . . .  5
  91.     4.8  s or S. . . . . . . . . . . . . . . . . . . . . . . .  5
  92.     4.9  d or D. . . . . . . . . . . . . . . . . . . . . . . .  5
  93.     4.10 r or R. . . . . . . . . . . . . . . . . . . . . . . .  5
  94.     4.11 p or P. . . . . . . . . . . . . . . . . . . . . . . .  6
  95.     4.12 p- or P-. . . . . . . . . . . . . . . . . . . . . . .  6
  96.     4.13 l# or L#. . . . . . . . . . . . . . . . . . . . . . .  6
  97.     4.14 m or M. . . . . . . . . . . . . . . . . . . . . . . .  6
  98.     4.15 f or F. . . . . . . . . . . . . . . . . . . . . . . .  6
  99.     4.16 c or C. . . . . . . . . . . . . . . . . . . . . . . .  6
  100.     4.17 v of V. . . . . . . . . . . . . . . . . . . . . . . .  6
  101.     4.18 w or W. . . . . . . . . . . . . . . . . . . . . . . .  6
  102.     4.19 i or I. . . . . . . . . . . . . . . . . . . . . . . .  6
  103.     4.20 - and + . . . . . . . . . . . . . . . . . . . . . . .  6
  104.  
  105.     System Requirements. . . . . . . . . . . . . . . . . . . .  7
  106.  
  107.     Examples . . . . . . . . . . . . . . . . . . . . . . . . .  7
  108.  
  109.     Contacting the Author. . . . . . . . . . . . . . . . . . .  7
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.                                    page 2
  122.  
  123.                   Warranty Disclaimer
  124.                   -------------------
  125.  
  126.      THIS SOFTWARE AND MANUAL ARE SUPPLIED "AS IS". MICHAEL J. PIERCE
  127.      MAKES NO WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING
  128.      BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND
  129.      FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THIS SOFTWARE AND
  130.      ACCOMPANYING DOCUMENTATION. YOUR USE OF THIS SOFTWARE INDICATES
  131.      THAT YOU HAVE READ AND AGREE TO THESE AND THE OTHER TERMS INCLUDED
  132.      IN THIS DOCUMENTATION FILE AND ALL FILES SPECIFIED HEREIN.
  133.  
  134.  
  135.      IN NO EVENT SHALL MICHAEL J. PIERCE BE LIABLE FOR ANY DAMAGES
  136.      RESULTING FROM THE USE OF THIS SOFTWARE, INCLUDING BUT NOT LIMITED
  137.      TO, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION,
  138.      LOSS OF DATA OR BUSINESS INFORMATION, INCIDENTAL OR CONSEQUENTIAL
  139.      DAMAGES, OR OTHER FINANCIAL LOSS ARISING OUT OF THE USE OF OR
  140.      INABILITY TO USE THIS PROGRAM, EVEN IF MICHAEL J. PIERCE HAS BEEN
  141.      ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  142.  
  143.  
  144.  
  145.                  License Terms
  146.                  -------------
  147.  
  148.     The software use and distribution license for users is contained
  149.      in the file LICENSE.DOC which should be included with this package.
  150.     The distribution license for vendors, BBS's, and similar groups
  151.      is contained int the accompanying file VENDOR.DOC.
  152.  
  153.  
  154.  
  155.                  Copyright Information
  156.                  ---------------------
  157.  
  158.     Mike's Directory Fast is copyrighted (c) 1995 by Michael Jonathon
  159.      Pierce.  No part of this program or package shall be reproduced or
  160.      distributed without written permission from the author except when
  161.      done in accordance with the license and distribution agreements
  162.      contained in exact copies of the original package distributed.
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.                                    page 3
  182.                  Introduction
  183.                  ------------
  184.  
  185.     Mike's Directory Fast is a FAST color coded sorted directory
  186.      lister for DOS.  Even with so many other sorted directory listers
  187.      out there I could not find one that had all the features I wanted.
  188.      The main problem I had was that other listers did not put the dot
  189.      '.' in the file names when they were displayed.  It was a hassle to
  190.      cut and paste from other listers to the command line and then
  191.      have to add the dot manually.
  192.     I also found features implemented in some packages and not in
  193.      others.  And I also came up with a few nice features of my own.  I
  194.      decided that it would be nice if all these features were in one
  195.      program so I wrote Mike's Directory Fast (MDIR).
  196.     While speed was not a prime consideration in the beginning of
  197.      this project I was pleased to see that my efficient design allowed
  198.      MDIR to run at least as fast and in most cases faster then any
  199.      other directory lister that I have tried.
  200.     Some of the main features are one, two, four, or six column
  201.      display, the ability to do listings of subdirectories, and self
  202.      paging for text mode displays.  As it turns out, MDIR also makes
  203.      a decent file finder.
  204.  
  205.  
  206.                  Installation
  207.                  ------------
  208.  
  209.     MDIR works best if you place it in a directory that is in your
  210.      path.  Those of you who need help, keep reading, the rest can skip
  211.      this section.
  212.     For installation you have three basic courses of action.  One,
  213.      copy the program into a directory in your path.  Two, copy the
  214.      program into a directory and then place that directory in your
  215.      path.  Or three, copy the program into any directory.
  216.  
  217.      2.1 Option One:
  218.  
  219.      Step 1
  220.     Locate the file AUTOEXEC.BAT on the disk or drive that
  221.      you will be booting from. Display the file by using the command
  222.      "TYPE AUTOEXEC.BAT" or something similar.  If the file is long and
  223.      runs off the top of the screen too fast try the command
  224.      "TYPE AUTOEXEC.BAT | MORE" and hitting the space bar to advance the
  225.      screens.
  226.  
  227.      Step 2
  228.     Locate the line in AUTOEXEC.BAT the says "PATH=" something
  229.      the simplist line is usually "PATH=C:\;C:\DOS".  If there is more
  230.      than one directory they should be separated by a ';'.  Choose one
  231.      of these directories as your destination directory.
  232.  
  233.      Step 3
  234.     When your current directory is the directory and disk where the
  235.      package is located use the command "COPY *.* `destination'" where
  236.      destination, with out the `', is the destination directory from step
  237.      2.  For example, if the package is on drive A and in the root
  238.      directory of that disk do the following if you want to copy the
  239.  
  240.  
  241.                                    page 4
  242.      package to the root directory of C drive:
  243.           CD A:\
  244.     COPY *.* C:\
  245.  
  246.      2.2 Option Two
  247.  
  248.      Step 1
  249.     Follow step 1 from above.
  250.  
  251.      Step 2
  252.     Edit, or create, AUTOEXEC.BAT adding your destination directory
  253.      to the path.  Be sure to separate it from the last directory in
  254.      your path with a semicolon ';'.  Please remember that the path can
  255.      only be 128 characters long unless you use some other path extension
  256.      utility.
  257.  
  258.      Step 3
  259.     Follow step 3 from above.
  260.  
  261.      2.3 Option Three
  262.  
  263.      The only step is to follow step 3 from above.  This option does not
  264.      make much sense to use because in order to run the program you must
  265.      either be using the directory that the program is located in as your
  266.      current directory, or specify where the program is located at the
  267.      command line.  This takes time and makes MDIR more trouble that it
  268.      is worth.
  269.  
  270.      2.4 Hints
  271.     There are two things that I noticed make it nicer to run MDIR.
  272.      First, it helps to have a disk cache.  Second, I have shortened the
  273.      name to M.EXE making it easier to run.
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.                                    page 5
  302.  
  303.                      Usage
  304.                      -----
  305.  
  306.      The command line usage is as follows:
  307.     "MDIR [[options] [directory][\filter]] ..."
  308.     What does this mean?  MDIR can be run with no command line
  309.      options.  This will give you a listing of the current directory.
  310.      Directories for listing can be specified.  The options will effect
  311.      only the directories that follow them.  Any number of options and
  312.      directories can be specified as long as the command line is less
  313.      than 128 characters long, DOS limit.
  314.  
  315.  
  316.                     Options
  317.                     -------
  318.  
  319.      All options must be preceded by a '-' or a '/', not a '\'.  Default
  320.      means that the option is active if it is not overridden.
  321.  
  322.      4.1  h or H or ?
  323.      Help, Gives a brief help message including all the options.
  324.      the character '|' means or so an option listed as "h|H|?" can
  325.      be activated by "-h" or "-H" or "-?".
  326.  
  327.      4.2  1
  328.      One column display, Displays extended file information
  329.      including name, size, date and time of last update, and the
  330.      System, Read only, Hidden, and Archive flags.
  331.  
  332.      4.3  2
  333.      Two column display, Displays name, size, and date and time of
  334.      last update.
  335.  
  336.      4.4  4
  337.      Four column display, Displays name and size.  This is the
  338.      default.
  339.  
  340.      4.5  6
  341.      Six column display, Displays only the name.
  342.  
  343.      4.6  e or E
  344.      Sort by extension, then by base name within a set of extensions.
  345.      This is the default.
  346.  
  347.      4.7  n or N
  348.      Sort by the base name and then by the extension within a set of
  349.      base names
  350.  
  351.      4.8  s or S
  352.      Sort by size, then by the name if sizes are equal.
  353.  
  354.      4.9  d or D
  355.      Sorts by date and time of last update.
  356.  
  357.      4.10 r or R
  358.      Unsorted or Raw display.
  359.  
  360.  
  361.                                    page 6
  362.  
  363.      4.11 p or P
  364.      Pauses the display between pages.  This is default.
  365.  
  366.      4.12 p- or P-
  367.      No Pausing between screen pages.  No space between the 'p' and
  368.      the '-'.
  369.  
  370.      4.13 l# or L#
  371.      Listing of subdirectories.  The '#' here is replaced by a
  372.      number to limit the depth of the listing or left blank to go
  373.      down as far a possible.
  374.  
  375.      4.14 m or M
  376.      Minimal listing, does the basic listing but does not display
  377.      any information that takes extra time.  This is fast because
  378.      sometimes the search for the Volume Serial Number takes a little
  379.      time.
  380.  
  381.      4.15 f or F
  382.      Full information listing, gives the directory, Volume Label,
  383.      free space, file count, total size, and the Volume Serial Number
  384.      if any.  This is default.
  385.  
  386.      4.16 c or C
  387.      Force 25 line display mode.  This will change the display mode
  388.      if different from the current mode.  MDIR figures out what the
  389.      current mode is if no video mode is specified.
  390.  
  391.      4.17 V or V
  392.      Force 43 line display for EGA monitors or 50 lines for VGA
  393.      monitors.
  394.  
  395.      4.18 w or W
  396.      Turn off direct screen writing.  If you have trouble with the
  397.      display when you run MDIR then try this option.
  398.  
  399.      4.19 i or I
  400.      Display registration information, including registration number
  401.      and name if the program is registered.
  402.  
  403.      4.20 - and +
  404.      - sorts in descending order, + sorts in acceding order.  + is
  405.      the default.
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.                                    page 7
  422.  
  423.                   System Requirements
  424.                   -------------------
  425.  
  426.      MDIR has been tested with DOS 3.3, 5.0, 6.0, and 6.2 but should
  427.       work with any DOS 2.1 and above.  It should also work on any IBM
  428.       PC and compatibles.
  429.  
  430.                    Examples
  431.                    --------
  432.  
  433.      I have included a few examples here to try to clear up anything
  434.       that might be confusing.
  435.      MDIR
  436.       Full listing of the current working directory, includes directory
  437.       name, Volume Name (if any), file count and size, disk free space,
  438.       and Volume Serial Number (if any).
  439.  
  440.      MDIR *.c *.cpp
  441.       List all files with the .c or .cpp extension.
  442.  
  443.      MDIR ..\*.c *.cpp
  444.       List all files with the *.c extension in the parent directory and
  445.       all files with the .cpp extension in the current working
  446.       directory.
  447.  
  448.      MDIR -L1 *.c *.cpp
  449.       List all files in the current working directory or any
  450.       subdirectories with the extension .c or .cpp.
  451.  
  452.      MDIR -L *.c *.cpp
  453.       List all files in the current working directory and directories
  454.       below it with the extension .c or .cpp.
  455.  
  456.      MDIR -L c:\*.c
  457.       List all files of drive C with the extension .c.
  458.  
  459.  
  460.                  Contacting the Author
  461.                  ---------------------
  462.  
  463.      I would appreciate any feed back you can give even if you don't
  464.       register the program.  If you do send me feedback and you have not
  465.       registered I will not harass you about it.  Just drop me a
  466.       post card at P.O. Box 68113, Raleigh NC 27613.  Or send me E-mail
  467.       at mjpierce@nando.net.
  468.  
  469.